home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / util / cli / pg.lha / pg.readme < prev   
Text File  |  1996-03-05  |  2KB  |  60 lines
  1. short: Amiga pager w/ source
  2. author: Thomas.Radtke@rz.uni-osnabrueck.de
  3. uploader: Thomas.Radtke@rz.uni-osnabrueck.de
  4. type: util/cli
  5.  
  6. ---------------------------------------------
  7. |-> REPLACEMENT FOR MY OLD ARCHIVE PG.LHA <-|
  8. ---------------------------------------------
  9.  
  10. This small pager helps you to format input from stdin. It knows
  11. about your console window size (if any, else one will be created) and
  12. interrupts the output every page (well, this is what a pager should
  13. do). You can enter 'q' after the [More] input request to switch off
  14. the formatting, text goes then directly to stdout.
  15.  
  16. 'pg' is freeware, (C) Thomas Radtke 1996.
  17.  
  18. Installation:
  19.  
  20. copy the pg command to anywhere in your command path. Do with the rest
  21. what you want.
  22.  
  23. Syntax:
  24.  
  25. pg [filename]
  26.  
  27. If the filename is omitted, source of input is stdin.
  28. Note: pg can be started from workbench, please do not rename the
  29. command. This is important!
  30.  
  31. Examples:
  32.  
  33. dir | pg    ;    from stdin
  34. pg pg.c        ;    from file pg.c
  35. pg <pg.c    ;    from stdin
  36.  
  37. -> You may want to have a 'pipe' command installed. Take a look at
  38.    various projects on Aminet.
  39.  
  40. bugs:
  41.  
  42. (i) not really a bug, but...
  43.  
  44. The pager does not work with output that goes to stderr, like gnuc's
  45. error reports (however, it works with Aztec-C :).
  46.  
  47. (ii) expected bug
  48.  
  49. For bugs, pg is a very atractive place to be. If you  have a different
  50. input handler, or the text to be formatted contains CSI sequences,
  51. output could be very well trash. If YOU know a way to determine the
  52. size of a string (in units of visible characters) on the console, let
  53. me know. On way is to create a virtuel console, send output to it and
  54. take a look at the results. Good luck if you want to try something
  55. similar.
  56.  
  57. Enjoy,
  58.  
  59. Thomas Radtke
  60.